home *** CD-ROM | disk | FTP | other *** search
/ CD Actual Thematic 7: Programming / CDAT7.iso / demos / VisualAge for Java 2.0 Entry / setup / data1.cab / ide-e / IDE / RELNOTES / EX.TXT next >
Encoding:
Text File  |  1998-09-16  |  12.2 KB  |  393 lines
  1. ===========================================================================
  2.  
  3.                           VisualAge for Java
  4.                              Version 2.0
  5.                                    
  6.                                Examples
  7.  
  8.                             RELEASE NOTES
  9.  
  10. ===========================================================================
  11.  
  12. Table of Contents
  13.  
  14. 1.0 Introduction
  15. 2.0 Loading Projects
  16. 3.0 Visual Composition Editor Examples
  17.    3.1 Running the Visual Composition Editor Examples
  18.    3.2 Known problems with the Visual Composition Editor Examples
  19.        3.2.1 com.ibm.ivj.examples.vc.beandemo
  20.  
  21. 4.0 Getting Started Examples
  22. 5.0 Towers of Hanoi
  23. 6.0 Sun BDK Examples
  24.    6.1 Adding Sun BDK Beans to the Visual Composition 
  25.        Editor Pallet
  26.    6.2 Known Problems with the Sun BDK Examples
  27.        6.2.1 Adding Beans to Sun's BeanBox Demo
  28.        6.2.2 BridgeTester Bean
  29.  
  30. 7.0 Sun JDK Examples
  31.    7.1 Running the Sun JDK Examples
  32.    7.2 Known Problems with the Sun JDK Examples
  33.        7.2.1 Sun JDK Animator
  34.        7.2.2 Sun JDK Clock
  35.        7.2.3 Sun JDK DrawTest
  36.        7.2.4 Sun JDK SymbolTest
  37.  
  38. 8.0 Sun JFC Examples
  39.    8.1 Running the Sun JFC Examples
  40.  
  41. 9.0 Awt Examples
  42.    9.1 Running the Awt Examples
  43.  
  44.  
  45. 1.0 Introduction
  46.  
  47. VisualAge for Java 2.0 ships with example applications and
  48. applets to help you start exploring VisualAge.
  49.  
  50. The examples fall into six categories:
  51.  
  52.    Visual Composition Editor Examples
  53.    Getting Started Examples
  54.    Towers of Hanoi
  55.    Sun BDK Examples
  56.    Sun JDK Examples
  57.    Awt Examples
  58.  
  59. Each of the example categories will be covered in the following
  60. sections.
  61.  
  62.  
  63. 2.0 Loading Features
  64.  
  65. The examples are contained in various features. Use the following
  66. steps to load a feature from the repository into your workspace:
  67.  
  68.   1)  Select a Workbench.
  69.   2)  Select "Quick Start" from the file menu.
  70.   3)  In the list on the left, select "Features".
  71.   4)  In the list on the right, select, "Add Feature".
  72.   5)  Select the example you want to load.
  73.   6)  Press the "OK" button when you have selected all the
  74.       features you wish to load.
  75.  
  76. For detailed explanations of the features, the repository, the workspace
  77. and how to manipulate projects please consult the printed or on-line
  78. documentation.
  79.  
  80. 3.0 Visual Composition Editor Examples
  81.  
  82. The Visual Composition Editor Examples are contained in the IBM Java
  83. Examples project.  The examples show complete working applets and
  84. applications constructed using the Visual Composition Editor.
  85.  
  86. If the IBM Java Examples project is not visible in the "Projects" tab
  87. of your Workbench you must load the project from the repository using
  88. the steps described in section 2.0 of this release note.
  89.  
  90. Each Visual Composition Editor Example is contained in its own
  91. package in the IBM Java Examples project.  Not all the packages in
  92. the IBM Java Examples project are Visual Composition Editor examples.
  93. These other packages will be covered later in this release note.
  94.  
  95. The Visual Composition Editor Example packages are:
  96.  
  97.    com.ibm.ivj.examples.vc.beandemo
  98.    com.ibm.ivj.examples.vc.bookmarklist
  99.    com.ibm.ivj.examples.vc.customerinfo
  100.    com.ibm.ivj.examples.vc.layoutmanagers
  101.    com.ibm.ivj.examples.vc.mortgageamortizer
  102.    com.ibm.ivj.examples.vc.popupmenuexample
  103.    com.ibm.ivj.examples.vc.propertyeditors
  104.    com.ibm.ivj.examples.vc.todolist
  105.    com.ibm.ivj.examples.vc.utilitybeans
  106.    com.ibm.ivj.examples.vc.swing.actionexample
  107.    com.ibm.ivj.examples.vc.swing.bookmarklist
  108.    com.ibm.ivj.examples.vc.swing.directoryexplorer
  109.    com.ibm.ivj.examples.vc.swing.layoutmanagers
  110.    com.ibm.ivj.examples.vc.swing.mortgageamortizer
  111.  
  112.  
  113. 3.1 Running the Visual Composition Editor Examples
  114.  
  115. Each package comment describes what the example does and also
  116. describes the steps to run the example.  To view a package comment:
  117.  
  118.   1)  Select a Workbench.
  119.   2)  Select the "Projects" tab.
  120.   3)  Select a project.  The text pane in the Workbench will
  121.       display the project comment.
  122.   4)  If the project is collapsed expand it by double
  123.       clicking the project name.
  124.   5)  Select a package.  The text pane in the Workbench will
  125.       display the package comment.
  126.  
  127.  
  128. 3.2 Known problems with the Visual Composition Editor Examples
  129.  
  130.  
  131. 3.2.1 com.ibm.ivj.examples.vc.beandemo
  132.  
  133. This example uses beans contained in the Sun BDK Examples project.
  134. This means that you have to load the project Sun BDK Examples before
  135. you can run this example.
  136.  
  137. You can load the Sun BDK Examples project before, at the same time or
  138. after you load the IBM Java Examples project.
  139.  
  140. If you loaded the IBM Java Examples project before loading the Sun
  141. BDK Examples project you would have noticed several compile errors
  142. that would show up in the "Unresolved Problems" tab of the Workbench.
  143. When you load the Sun BDK Examples these errors are automatically
  144. corrected.
  145.  
  146.  
  147. 4.0 Getting Started Examples
  148.  
  149. The Getting Started Examples are meant to be used hand in hand with
  150. either the printed or on-line version of the IBM VisualAge For Java
  151. Getting Started book.
  152.  
  153. The Getting Started Examples are contained in the IBM Java
  154. Examples project in the packages:
  155.  
  156.   com.ibm.ivj.examples.vc.todofile
  157.   com.ibm.ivj.examples.vc.todolist
  158.  
  159. For instructions on how to load and work with these examples please
  160. see the IBM VisualAge for Java Getting Started book.
  161.  
  162.  
  163. 5.0 Towers of Hanoi
  164.  
  165. The Towers of Hanoi example shows both a graphical applet and a
  166. textual application that recursively solves the classic Towers of
  167. Hanoi puzzle.
  168.  
  169. The Towers of Hanoi example is contained in the IBM Java Examples
  170. project.  For instructions on how to load this project see section
  171. 2.0 of this release note.
  172.  
  173. The Towers of Hanoi example is contained in the package:
  174.  
  175.   com.ibm.ivj.examples.hanoi.
  176.  
  177. The package comments describe how to run the example.  For
  178. instructions on viewing package comments please see section 3.1 of
  179. this release note.
  180.  
  181.  
  182. 6.0 Sun BDK Examples
  183.  
  184. The Sun BDK Examples are examples that Javasoft ships with their Sun
  185. BDK.
  186.  
  187. To load the Sun BDK Examples project follow the steps in section 2.0
  188. of this release note.
  189.  
  190. The Sun BDK Examples contain beans that you use in the Visual
  191. Composition Editor to build applets, applications and beans of your
  192. own.
  193.  
  194. For complete instructions on what each Sun BDK bean does please see
  195. the Sun BDK 1.0 documentation available on Javasoft's web page: 
  196.  
  197.    http://splash.javasoft.com/beans/index.html
  198.   
  199.  
  200. 6.1 Adding Sun BDK Beans to the 
  201.     Visual Composition Editor Palette
  202.  
  203. Before you can use imported beans in the Visual Composition Editor
  204. the beans must be added to the palette.  Adding beans to the pallet is
  205. covered in detail in the VisualAge documentation.
  206.  
  207.  
  208. 6.2 Known Problems with the Sun BDK Examples
  209.  
  210.  
  211. 6.2.1  Adding Beans to Sun's BeanBox Demo
  212.  
  213. If you want to add beans to the Sun BeanBox you must copy the *.jar
  214. files for the beans to the directory:
  215.  
  216.    \<ibmvjava>\ide\project_resources\jars
  217.  
  218. Where <ibmvjava> is the directory where you installed IBM VisualAge
  219. for Java.  
  220.  
  221. You must also import the *.jar files into IBM VisualAge for Java
  222. before trying to run the new beans from the Sun BeanBox.  Detailed
  223. instructions for importing *.jar can be found in the IBM VisualAge
  224. for Java documentation.
  225.  
  226. 6.2.2 BridgeTester Bean
  227.  
  228. We do not ship the BridgeTester Bean that ships with Sun BDK 1.0.
  229. This bean exposes a bug in Sun's java.beans package.
  230.  
  231.  
  232. 7.0 Sun JDK Examples
  233.  
  234. The Sun JDK Examples are examples that are shipped with Sun JDK 1.1.6.
  235.  
  236. Each Sun JDK Example is contained in its own project.  You can use
  237. the steps in section 2.0 of this release note to load the examples
  238. you are interested in.
  239.  
  240. For detailed instructions on what each example does please see the
  241. Sun JDK 1.1.6 documentation available on their web page.
  242.  
  243. The following Sun JDK example projects in the VisualAge repository:
  244.  
  245.   Sun JDK Animator
  246.   Sun JDK ArcTest
  247.   Sun JDK BarChart
  248.   Sun JDK Blink
  249.   Sun JDK CardTest
  250.   Sun JDK Clock
  251.   Sun JDK DitherTest
  252.   Sun JDK DrawTest
  253.   Sun JDK Fractal
  254.   Sun JDK Gauge
  255.   Sun JDK GraphicsTest
  256.   Sun JDK GraphLayout
  257.   Sun JDK i18n code
  258.   Sun JDK ImageMap
  259.   Sun JDK JumpingBox
  260.   Sun JDK MoleculeViewer
  261.   Sun JDK NervousText
  262.   Sun JDK OpenlookButtons
  263.   Sun JDK RoundButtons
  264.   Sun JDK SimpleGraph
  265.   Sun JDK SortDemo
  266.   Sun JDK Spinner
  267.   Sun JDK SpreadSheet
  268.   Sun JDK SymbolTest
  269.   Sun JDK TicTacToe
  270.   Sun JDK WireFrame
  271.  
  272.  
  273. 7.1 Running the Sun JDK Examples
  274.  
  275. Once a Sun JDK Example project is loaded you can run the applet using
  276. the following steps:
  277.  
  278.   1)  Open a Workbench.
  279.   2)  Select the "Projects" tab.
  280.   3)  Select the example project you wish to run.
  281.   4)  Press the "Run" button on the Workbench toolbar.
  282.   5)  Some examples are both applets and applications 
  283.       (i.e. they have main). By default VisualAge
  284.       will run these as applets. To run them as applications
  285.       choose Run -> main()from the popup menu of the project.
  286.  
  287.  
  288. 7.2 Known Problems with the Sun JDK Examples
  289.  
  290.  
  291. 7.2.1 Sun JDK Animator
  292.  
  293. If you select the restart option from the applet viewer menu while
  294. animator is running errors will be displayed on the Console.  The
  295. same behavior is present when this example is run under Sun JDK 1.1.6
  296.  
  297. Due to problems with the way the Animator example is written you may
  298. experience a deadlock condition if you run a large number of
  299. Animators.  The Sun JDK 1.1.6 experiences the same problem.
  300.  
  301.  
  302. 7.2.2 Sun JDK Clock
  303.  
  304. The graphical time display will show the current system time but the
  305. textual time may be incorrect.
  306.  
  307.  
  308. 7.2.3 Sun JDK DrawTest
  309.  
  310. If you are running IBM VisualAge for Java in Windows 95 or Windows NT
  311. and are using 256 colors then the fourth radio button from the left
  312. will not draw with the displayed color.  This is a known problem that
  313. has to do with the way Windows allocates colors.  The problem does
  314. not appear if you have a higher color resolution or if you are running IBM
  315. VisualAge for Java under OS/2.
  316.  
  317.  
  318. 7.2.4 Sun JDK SymbolTest
  319.  
  320. The symbols will not be displayed.  Instead you will see the escape
  321. codes for the symbols.  This is a known problem.
  322.  
  323.  
  324. 8.0 Sun JFC Examples
  325.  
  326. The Sun JFC Examples are examples that Sun ships with their 
  327. JFC 1.02.
  328.  
  329. Each Sun JFC Example is contained in its own project.  You can use
  330. the steps in section 2.0 of this release note to load the examples
  331. you are interested in.
  332.  
  333. For detailed instructions on what each example does please see the
  334. Sun JFC 1.02 documentation available on their web page.
  335.  
  336. The following Sun JFC example projects in the VisualAge repository:
  337.  
  338.   Sun JFC DBDemos
  339.   Sun JFC FileChooserDemo
  340.   Sun JFC MetalWorksDemo
  341.   Sun JFC Notepad
  342.   Sun JFC SampleTree
  343.   Sun JFC Simple
  344.   Sun JFC Stylepad
  345.   Sun JFC SwingApplet
  346.   Sun JFC SwingSet
  347.   Sun JFC Table
  348.  
  349.  
  350. 8.1 Running the Sun JFC Examples
  351.  
  352. Once a Sun JFC Example project is loaded you can run the applet using
  353. the following steps:
  354.  
  355.   1)  Open a Workbench.
  356.   2)  Select the "Projects" tab.
  357.   3)  Select the example project you wish to run.
  358.   4)  Press the "Run" button on the Workbench toolbar.
  359.   5)  Some examples are both applets and applications 
  360.       (i.e. they have main). By default VisualAge
  361.       will run these as applets. To run them as applications
  362.       choose Run -> main()from the popup menu of the project.
  363.  
  364.  
  365. 9.0 Awt Examples
  366.  
  367. The Awt Examples are detailed test cases for the Java Awt classes.
  368. The Awt Examples are contained in the IBM Java Examples project.  To
  369. load this project follow the steps in section 2.0 of this release
  370. note.
  371.  
  372. The packages that comprise the Awt tests are:
  373.   com.ibm.ivj.examples.awttestframework
  374.   com.ibm.ivj.examples.awttestlauncher
  375.   com.ibm.ivj.examples.awttests
  376.  
  377. 9.1 Running the Awt Examples
  378.  
  379. Follow these steps to run the Awt Examples:
  380.  
  381.   1)  Open a Workbench.
  382.   2)  Select the "Projects" tab.
  383.   3)  Select the IBM Java Examples project.
  384.   4)  Press the "Run" button on the Workbench toolbar. 
  385.   5)  Some examples are both applets and applications 
  386.       (i.e. they have main). By default VisualAge
  387.       will run these as applets. To run them as applications
  388.       choose Run -> main()from the popup menu of the project.
  389.   6)  The AwtExampleLauncher will start.  Select one or more
  390.       examples from the list and press the "Execute"
  391.       button.  The example will run.
  392.  
  393.